package cn.tedu.yxcar.product.mapper;

import cn.tedu.yxcar.product.pojo.entity.Article;
import cn.tedu.yxcar.product.pojo.vo.ArticleDetailsVO;
import cn.tedu.yxcar.product.pojo.vo.ArticleListVO;
import cn.tedu.yxcar.product.pojo.vo.ArticleSearchVO;
import cn.tedu.yxcar.product.pojo.vo.AuthorInfoVO;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;

/**
 * 处理文章数据的Mapper接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
@Repository
public interface ArticleMapper {
    /**
     * 插入文章数据
     *
     * @param article 文章数据
     * @return 受影响的行数
     */
    int insert(Article article);

    /**
     * 根据id删除文章数据
     *
     * @param id 文章id
     * @return 受影响的行数
     */
    int deleteById(Long id);

    /**
     * 根据id修改文章数据
     *
     * @param article 封装了文章id和新数据的对象
     * @return 受影响的行数
     */
    int update(Article article);

    /**
     * 统计文章数据的数量
     *
     * @return 文章数据的数量
     */
    int count();

    /**
     * 根据文章名称统计数据的数量
     *
     * @param title 文章名称
     * @return 匹配名称的文章数据的数量
     */
    int countByTitle(String title);

    /**
     * 统计非某id但名称匹配的文章数据的数量，用于检查是否存在其它数据使用了相同的名称
     *
     * @param id   文章id
     * @param title 文章名称
     * @return 匹配名称但不匹配id的数据的数量
     */
    int countByTitleAndNotId(@Param("id") Long id, @Param("title") String title);


    /**
     * 根据id查询文章数据详情
     *
     * @param id 文章id
     * @return 匹配的文章数据详情，如果没有匹配的数据，则返回null
     */
    ArticleDetailsVO getStandardById(Long id);

    /**
     * 根据用户id查询用户信息
     *
     * @param userId 用户id
     * @return 匹配的作者数据
     */
    AuthorInfoVO getAuthorInfo(Long userId);

    /**
     * 查询文章数据列表
     *
     * @return 文章数据列表
     */
    List<ArticleListVO> list();
    
    /**
     * 通过关键字查询文章
     *
     * @param keywords 关键字
     * @return 搜索结果列表
     */
    List<ArticleSearchVO> listSearchByKeywords(String keywords);

    /**
     * 浏览量增加
     *
     * @param id 文章id
     */
    void updateViewCountById(Long id);

}
